Massenprodukt-Update

CC-Dokumentation Massenprodukt-Update

1. Einführung
2. Einrichtung
3. Aktivierung der Lizenz
4. Management-Panel
5. Dateiimport
6. Massenaktualisierung nach Kriterien
7. CRON-Aufgaben
8. Anmeldesystem
9. Arten von Produktidentifikatoren
10. Spaltenzuordnung
11. Lösung von Problemen
12. FAQ

1. Einleitung

• Import von CSV-, XLS-, XLSX-Dateien aus verschiedenen Quellen (Upload, Server, URL)
• Massenaktualisierung von Produkten nach Kriterien (Kategorien, Preisklassen, Hersteller)
• Unterstützung von CRON-Aufgaben im dualen Modus (Konfiguration und URL-Parameter)
• Unterstützung für verschiedene Arten von Produktidentifikatoren (ID, EAN, UPC, ISBN, MPN, Referenz, GTIN)
• Fortschrittliches Protokollierungssystem für den Betrieb
• Intuitive Spaltenzuordnung mit Dateivorschau
• Validierung und Fehlerkontrolle
• System zur Verwaltung von Lizenzen
• Speichern von Benutzereinstellungen

2. Einbau

• PrestaShop 1.7 oder höher
• PHP 7.1 oder höher
• PHP-Erweiterung: PhpSpreadsheet (für Excel-Dateien)
• Minimaler Speicher: 128MB
• Erlaubnis zum Erstellen temporärer Verzeichnisse

1. Laden Sie die ZIP-Datei des Moduls aus dem offiziellen Shop herunter cocos.codes
2. Loggen Sie sich in das PrestaShop-Administrationspanel ein
3. Gehen Sie zu: Module → Modulmanager → Neues Modul hinzufügen
4. Klicken Sie auf "Modul hinzufügen" und wählen Sie die heruntergeladene ZIP-Datei aus.
5. Wenn die Installation abgeschlossen ist, klicken Sie auf "Konfigurieren".
6. Das Modul erstellt automatisch temporäre Verzeichnisse und installiert die erforderlichen Einstellungen.

3. die Aktivierung der Lizenz

1. Nach der Installation fahren Sie mit der Modulkonfiguration fort
2. Wählen Sie die Registerkarte "Lizenz".
3. Geben Sie den nach dem Kauf erhaltenen Lizenzschlüssel ein
4. Klicken Sie auf "Lizenz aktivieren".
5. Nach erfolgreicher Aktivierung erhalten Sie eine Bestätigungsmeldung und alle Funktionen sind freigeschaltet.

4 Management-Panel

• Dateiimport - Datenimport aus CSV/Excel-Dateien
• Massenaktualisierung - Aktualisierung der Produkte nach Kriterien
• CRON-Aufgaben - Automatisierungskonfiguration
• Protokolle - Anzeige und Verwaltung von Betriebsprotokollen

• Einstellungen - Allgemeine Konfiguration des Moduls
• Dokumentation - Link zum Online-Handbuch
• Unterstützung - Zugang zu technischer Hilfe
• Plug-ins - Informationen über zusätzliche Erweiterungen
• Lizenz - Modul Lizenzmanagement

5. Datei-Import

• Hochladen von Dateien - Hochladen einer Datei direkt von Ihrem Computer
• Pfad auf dem Server - Angabe der auf dem Server befindlichen Datei
• URL zur Datei - Herunterladen einer Datei von einer externen URL

• CSV (mit automatischer Trennzeichenerkennung: , ; | Tab)
• XLS (ältere Excel-Dateien)
• XLSX (neuere Excel-Dateien)

1. Wählen Sie die Quelle der Datei
2. Geben Sie die Datei an (Upload, Pfad oder URL)
3. Wählen Sie den Typ des Produktidentifikators
4. Feststellen, ob die Datei Kopfzeilen enthält
5. Klicken Sie auf "Vorschau und Mapping".
6. Zuordnung der Datenspalten (Bezeichner, Menge, Preis)
7. Klicken Sie auf "Import durchführen".

• Maximale Dateigröße: 10MB (konfigurierbar)
• Überprüfung von Dateiformat und -integrität
• Validierung der Datenstruktur
• Kontrolle der Verfügbarkeit externer Dateien

6. massenhafte Aktualisierung nach Kriterien

• Kategorien - Auswahl von Produkten aus bestimmten Kategorien
• Produkt-ID-Bereich - von einer bestimmten ID zu einer bestimmten ID
• Preisspanne - Produkte mit Preisen innerhalb einer bestimmten Spanne
• Hersteller - die Produkte eines bestimmten Herstellers
• Status - aktive oder inaktive Produkte

• Neue Menge - Festlegung einer bestimmten Menge für alle ausgewählten Produkte
• Neuer Preis - Festlegung eines bestimmten Preises für alle ausgewählten Produkte
• Es ist möglich, Menge und Preis gleichzeitig zu aktualisieren oder nur einen der beiden Parameter

1. Produktauswahlkriterien auswählen
2. Neue Werte definieren (Menge und/oder Preis)
3. Klicken Sie auf "Produkte aktualisieren".
4. Das System zeigt die Anzahl der aktualisierten Produkte und eventuelle Fehler an

7 Aufgaben von CRON

• Abspeichern der Einstellungen in der Datenbank
• Eine CRON-Aufgabe für alle automatischen Aktualisierungen
• Einfache Konfiguration über Webinterface
• Aufgabe URL: /modules/cc_ps_mass_update_product/controllers/front/cron.php?token=...

• Übergabe aller Parameter direkt in der URL
• Möglichkeit, viele verschiedene CRON-Aufgaben zu erstellen
• Flexible Konfiguration für fortgeschrittene Benutzer
• Jede Aufgabe kann unterschiedliche Einstellungen haben

1. Aktivieren Sie "CRON-Aufgaben".
2. Wählen Sie die Quelle der Datei (Server oder URL)
3. Geben Sie den Pfad oder die URL zu der Datei an
4. Konfigurieren Sie den Bezeichnertyp und die Spaltenzuordnung
5. Speichern Sie Ihre Einstellungen
6. URL zur Server-Crontab hinzufügen

• Token - Sicherheits-Token (erforderlich)
• Quelle - Quelle der Datei (Server|Url)
• file_path - Pfad zur Datei auf dem Server
• datei_url - URL zur Datei
• Bezeichner_Typ - Art des Produktidentifikators
• has_header - ob die Datei Kopfzeilen enthält (1|0)
• karten_identifikator - Identifikator Spaltennummer
• mapping_quantity - Spaltennummer mit Menge
• kartierung_preis - Preisspaltennummer

# Jeden Tag um 2:00 Uhr - Konfigurationsmodus
0 2 * * * /usr/bin/curl "https://sklep.pl/modules/cc_ps_mass_update_product/controllers/front/cron.php?token=abc123"
Täglich um 3:00 Uhr - Aktualisierungsmengen vom Server
0 3 * * * /usr/bin/curl "https://sklep.pl/modules/cc_ps_mass_update_product/controllers/front/cron.php?token=abc123&source=server&file_path=/var/www/files/quantities.csv&identifier_type=ean&has_header=1&mapping_identifier=0&mapping_quantity=1"
Täglich um 4:00 Uhr - Preisaktualisierung von der URL
0 4 * * * /usr/bin/curl "https://sklep.pl/modules/cc_ps_mass_update_product/controllers/front/cron.php?token=abc123&source=url&file_url=https://dostawca.pl/prices.csv&identifier_type=reference&has_header=1&mapping_identifier=0&mapping_price=2"

8 Anmeldesystem

• Automatische Protokollierung aller Aktualisierungsvorgänge
• Verschiedene Protokollierungsebenen (INFO, WARNING, ERROR)
• Getrennte Protokolldateien für jeden Tag
• Einsicht in die Protokolle direkt im Verwaltungsbereich
• Möglichkeit zum Herunterladen vollständiger Protokolldateien
• Automatische Reinigung von alten Stämmen

• Login-Status - Protokollspeicherung aktivieren/deaktivieren
• Liste der Protokolldateien - Übersicht über alle Dateien mit Datum und Größe
• Vorschau der Protokolle - Anzeige der letzten 200 Zeilen mit Einfärbung nach Level
• Herunterladen von Protokollen - vollständige Protokolldateien herunterladen
• Aufräumen alter Baumstämme - Löschung von Protokollen, die älter als 30 Tage sind

[2025-01-15 14:30:22] [INFO] Start der Massenaktualisierung aus Datei: /var/www/files/products.csv
[2025-01-15 14:30:23] [INFO] Produktmenge aktualisiert: ID 123, Menge: 50
[2025-01-15 14:30:23] [WARNING] Produkt nicht gefunden durch EAN-Code: 1234567890123
[2025-01-15 14:30:25] [INFO] Massenaktualisierung abgeschlossen | Kontext: {"success":45, "failed":2}

9 Arten von Produktidentifikatoren

• Produkt-ID - am schnellsten, erfordert aber die Kenntnis der internen IDs
• Referenz/SKU - die am häufigsten in Online-Shops verwendet werden
• EAN - Standard für physische Produkte
• GTIN - universell, prüft alle möglichen Barcodes

10. Spaltenzuordnung

1. Nach der Auswahl der Datei zeigt das System eine Vorschau der ersten 5 Zeilen an
2. Der Benutzer gibt an, welche Spalte den Produktidentifikator enthält
3. Optionale Angabe von Spalten mit Menge und/oder Preis
4. Das System prüft die Korrektheit des Mappings
5. Nach der Genehmigung werden die Daten importiert

• Spalte Bezeichner - immer erforderlich
• Spalte Menge - fakultativ (ganze Zahlen ≥ 0)
• Spalte Preis - optional (reelle Zahlen ≥ 0, max. 2 Nachkommastellen)
• Mindestens eine der Spalten (Menge oder Preis) muss abgebildet werden
• Die Spalten dürfen nicht identisch sein

• Das Modul speichert automatisch die letzten Mappings im localStorage
• Zuordnungen werden für Dateien mit identischer Struktur wiederhergestellt
• Jedes Mapping enthält Informationen über den Bezeichnertyp und die Kopfzeilen
• Zuordnungen sind 7 Tage lang gültig.
• Möglichkeit, gespeicherte Einstellungen manuell zu löschen

ean,name,menge,preis
1234567890123,"Produkt A",50,19.99
1234567890124,"Produkt B",30,29.99
1234567890125,"Produkt C",0,39.99

11 Fehlersuche

1. Prüfen Sie, ob das Modul eine aktive Lizenz hat
2. Stellen Sie sicher, dass die Datei ein unterstütztes Format hat (CSV, XLS, XLSX)
3. Dateigröße prüfen (standardmäßig max. 10 MB)
4. Überprüfen Sie bei Dateien vom Server die Leseberechtigungen
5. Prüfen Sie bei der URL die Verfügbarkeit und Richtigkeit der Adresse
6. Überprüfen Sie die Modulprotokolle auf Einzelheiten des Fehlers

1. Korrektheit der Spaltenzuordnung prüfen
2. Überprüfen Sie den Typ des Produktidentifikators
3. Sicherstellen, dass die Bezeichner in der Datei korrekt sind
4. Prüfen, ob Produkte im Shop vorhanden sind
5. Überprüfen Sie das Datenformat (Zahlen für Mengen und Preise)
6. Protokolle auf Warnungen überprüfen

1. Validierung des Sicherheitstokens
2. Stellen Sie sicher, dass cron in der Konfiguration aktiviert ist (Konfigurationsmodus)
3. Überprüfen Sie die Verfügbarkeit der Quelldatei
4. Überprüfen Sie die CRON-Aufgabenprotokolle auf dem Server
5. Stellen Sie sicher, dass die URL der CRON-Aufgabe korrekt ist
6. Prüfen, ob der Server HTTP-Anfragen ausführen kann

1. Verringern Sie die Größe der importierten Dateien
2. Erhöhen Sie das Zeitlimit für die PHP-Ausführung (max_execution_time)
3. PHP-Speicherlimit erhöhen (memory_limit)
4. Deaktivieren der Protokollierung für sehr große Importe
5. Verwenden Sie CRON-Aufgaben anstelle von browserbasierten Importen
6. Große Dateien in kleinere Stücke aufteilen

12. FAQ